Determines whether the flag bit for an attribute has been set in the gdFlags field of a GDevice structure.

Boolean TestDeviceAttribute (
    GDHandle gdh, 
    SInt16 attribute
);

Parameter descriptions

gdh

A handle to a GDevice structure.

attribute

One of the specific constants, which represent bits in the gdFlags field of a GDevice structure. See “Device Attribute Constants” for a description of the values you can use in this parameter.

function result

TRUE if the bit of the graphics device attribute specified in the attribute parameter is set to 1. Otherwise, TestDeviceAttribute returns FALSE.

DISCUSSION

Use the SetDeviceAttribute function to change any of the flags tested by the TestDeviceAttribute function.

SPECIAL CONSIDERATIONS

The TestDeviceAttribute function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)